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The Lemur (2005-2010) 



V2/More control 
than ever before 


the only multitouch and modular controller 
tor sequencers, synthesizers, virtual instruments, 

vjing and lights, now even better 



johannes GUTEN BERG 
universitAt mainz 


□ ► < S' 


>00,0 





TouchOSC 


► configurable multitouch 
controller 

► runs on Android and iOS 

► TouchOSC Editor 

► communicates via OSC 
(OpenSoundControl) 

► MIDI support for “legacy” 
applications 

► works via RTP-MIDI (not 
supported on Android) or 
proprietary MIDI bridge 
(Mac/Windows only) 

► => no MIDI support on 

Linux:( 
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Pd-TouchOSC 


► TouchOSC MIDI bridge in Pd 

► reads MIDI mapping from TouchOSC layout 

► translates between OSC and MIDI on the fly 

► Zeroconf support (via Avahi on Linux, Bonjour on the Mac) 

► written (mostly) in Pure (~ 500 lines Pure, ~ 130 lines C) 

► Pd library touchosc with core externals toosc, tomidi and 
oscbrowser, compiles to native binary (. so on Linux) 

► uses mrpeach externals for OSC connectivity 

► touchosc-bridge patch glues everything together 
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Download 


► You’ll need: 

► Pd (+ cyclone, mrpeach) 

► Pure (+ pd-pure, pure-stldict, pure-xml) 

► TouchOSC 

► Get it at Bitbucket: 

https://bitbucket.org/agraef/pd-touchosc 

► Arch User Repositories: 

https://aur.archlinux.org/packages/pd-touchosc-git 

► Binaries for Arch Linux and Mac OS X available 

► Find my other projects on Bitbucket: 

https://bitbucket.org/agraef/agraef.bitbucket.org __ 

Bala 
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TouchOSC Layouts 


<?xml version="l.0" encoding="UTF-8"?> 

<layout version="13" mode="0" orientation="vertical"> 
■ctabpage name="MQ==" scalef="0.0” scalet="1.0" > 
<control name="ZmFkZXIx" x="44" y="48" w=”50" h="200" 
color="red" scalef="0.0" scalet="1.0" 
type="faderv" response="absolute" 
inverted="false" centered="false" > 

<midi var ="x" type="0” channel="l" datal="l" 
data2f="0" data2t="127" /> 

</control> 

</tabpage> 

</layout> 
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TouchOSC Widgets 


► Available widgets: 

► faders 

► rotary controls (knobs, encoders) 

► push and toggle buttons (0/1) 

► XY pads (x,y coordinates) 

► Multi-widgets: arrays of faders, buttons and XY pads 


Widgets can be arranged on multiple pages (tabbed interface) 
which have their own OSC addresses (/l, /2, etc.). 

Widget coordinates and dimensions are absolute (no automatic 
layout), but the editor provides various operations to align and 
arrange them on a page. 
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Control Variables 


► Variable types: 

► input variables: change widget state when received on device 

► output variables: sent to host when operated on device 

► Available variables: 

► x: primary control value (input/output) 

► y: secondary control value (XY pads; input/output) 

► z: touch value (0/1; output only) 

► c: color (0..8; input only) 
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TouchOSC Messages 


OSC Message 

Meaning 

/I 

first page 

/1/faderl 0.1 

x value of faderl 

/1/faderl/color red 

color (input only) 

/1/faderl/z 1 

touch value (output only) 

/1/xyl 0.1 0.7 

x, y values of a XY pad 

/1/multifaderl/l 0.1 

1st subcontrol of a multi-fader 

/1/multifaderl/l/z 1 

touch value of subcontrol 

/1/multixyl/l 0.1 0.7 

1st subcontrol of a multi-XY pad 

/l/multipushl/2/3 0.1 

subcontrol in column 2, row 3 


johannes GUTEN BERG 
UNIVERSITAT MAINZ 

□ «!►<!► 1 -O 0,0 





MIDI Mapping 


► Voice messages generally map the last data byte only. 

► Pitch bend messages map the entire 14 bit value (MSB+LSB). 

► Realtime sequencer messages (start/stop/continue) may be 
mapped to 0/1 variables (buttons, touch). 

► Linear mapping from OSC (xi — * 2 ) to MIDI {y\ — y?)\ 

, 72 - yi, , 

y = y 1 H-(x - xi) 

X2 — Xi 
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MIDI Mapping 


Type 

Channel 

Fixed Data 

Mapped Data 

control change 

1-16 

controller 

value (0-127) 

note 

1-16 

note number 

velocity (0-127) 

program change 

1-16 

- 

program (0-127) 

start 

- 

- 

- 

stop 

- 

- 

- 

continue 

- 

- 

- 

key pressure 

1-16 

note number 

velocity (0-127) 

channel pressure 

1-16 

- 

velocity (0-127) 

pitch bend 

1-16 

- 

bend (0-16383) 
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MIDI Encoding in Pd 


► designed to facilitate interfacing with Pd’s MIDI objects 

► implemented by midi-input and midi-output patches 


Message Type 

Format 

Message Type 

Format 

note 

note five 

pitch bend 

bend v c 

control change 

ctl v n c 

start 

start 

program change 

pgm n c 

stop 

stop 

key pressure 

polytouch v n c 

continue 

cont 

channel pressure 

touch vc 




n = note/controller number, v = value/velocity, c = MIDI channel 
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TouchOSC Bridge Patch 


touc hose-bridge lay out-file I inport out port ] 
This patch requires the cyclone and mrpeach externals. 


8000 is the default input port, you can change this with the 
second creation parameter. 
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Simple Example 


explicitly connect output 
'connect 192.168.2.102 9000 



direct OSC output 
print osc 
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midi-output 
print midi 
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Network Connections 


► OSC via UDP (mrpeach or OSCx externals in Pd) 

► use Zeroconf for negotiating network addresses (osc.udp) 



Network 

7/^i 


Zeroconf «=>- 

X 

Host PC 

^ ^Avam/Donjourj 

OSC connection 

Mobile 

device 
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Demo 


► TouchOSC Editor 

► Transfer layout to device 

► Load layout in Pd 

► Establish OSC connection 

► Connect Pd with MIDI 
application 
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Conclusion 


► Pd-TouchOSC provides a TouchOSC MIDI Bridge for Linux 

► Advantages: 

► open protocol (OSC) 

► open source (Pure source code, Pd patch) 

► can easily be customized for your own purposes 

► cross-platform 

► Disadvantages: 

► requires an OSC connection to the device 

► layout file must be available on the host side 

► requires Pd right now (standalone version doable) 
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Future Work 


► TouchOSC is affordable and works well, but also has some 
drawbacks: 

► closed source 

► no automatic layouts, requires manual editing 

► no dynamic configuration of control elements 

► no customizable behaviours of control elements 

► Alternatives: 

► Liine’s Lemur (closed source; expensive; iOS-only) 

► Charlie Roberts’ Control (open-source; Android, iOS) 

► Hanjo Schumacher’s Bydcontrol (open-source; any browser) 

► Dynamic interface generation for Faust, LV2, ... 
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